home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / programs / zdcs201.zip / CONVERT.TXT next >
Text File  |  1993-02-02  |  10KB  |  217 lines
  1.           ZIPFILE DUPLICATE CHECKING SYSTEM (ZDCS)  Ver. 2.0
  2.               Copyright (C) 1991, 1992  Michael W. Cocke
  3.  --------------------------------------------------------------------
  4.  
  5.  
  6. CONVERTING FROM ZDCS 1.65 TO ZDCS 2.0
  7.  
  8. Thank you for having used ZDCS 1.65.  If you registered an earlier
  9. version of ZDCS, you'll find that your registration key continues to
  10. work with ZDCS 2.0.  Converting to version 2.0 is a simple process.
  11.  
  12. You'll need to do three things to change over to ZDCS 2.0:  convert
  13. your database format;  update your ZDCS configuration file;  and copy
  14. the new files into your ZDCS directory.
  15.  
  16. First, convert your existing database from the version 1.6x format to
  17. the new version 2.0 format.  While it's possible to do this across a
  18. LAN, it will add considerably to the time required.  Use the fastest
  19. hard drive and processor that you have available, and create a
  20. temporary working directory.  The conversion will take place in this
  21. temporary directory.
  22.  
  23. Copy your existing ZDCS.DAT, ZDCS.NDX and ZDCS.PTH files into this
  24. working directory.  Put a copy of the Z1TO2.EXE program in the same
  25. directory.
  26.  
  27. Run the Z1TO2.EXE utility =from= your working directory.  Z1TO2.EXE
  28. works only on the files in the same directory.  It does not use the
  29. database location information stored on line 2 of the ZDCS
  30. configuration file.  This is to make the conversion process more
  31. `portable' so that you can run it on another computer without
  32. interfering with the operation of the BBS.
  33.  
  34. When Z1TO2.EXE has finished processing the old database files, you
  35. will have two new files in the current directory.  Each file begins
  36. with N- to identify it as one of the newly created files.  Now you can
  37. delete the old files ZDCS.DAT, ZDCS.NDX and ZDCS.PTH.  Then rename N-
  38. ZDCS.DAT to ZDCS.DAT and N-ZDCS.NDX to ZDCS.NDX.  These two files
  39. together make up the new version 2.0 database.  That takes care of
  40. converting your database.
  41.  
  42. Note: It is possible that you have damaged information in your ZDCS
  43.       database.  This might have occurred while running some versions
  44.       of ZDCS 1.6x under certain conditions.  If this has happened,
  45.       running Z1TO2.EXE will reconstruct the vital information about
  46.       member files and CRC values for the database, although it won't
  47.       recover the name of the archive in which the member files were
  48.       located.
  49.  
  50.       However, when Z1TO2 encounters an instance of damage, it stops
  51.       to ask you whether you wish to continue with the reconstruction
  52.       or abort the entire process.  If you would like to run Z1TO2
  53.       unattended, you can use one of the two available switches:
  54.  
  55.       Z1TO2 A        Abort the entire process
  56.       Z1TO2 C        Continue with the reconstruction
  57.  
  58.  
  59. ZDCS 2.0 uses a different configuration file than version 1.6x did.
  60. It is now thirteen lines long - still a short and simple file.  You
  61. can consult the technical reference manual for full details to make
  62. sure you have the config file set up the way you want it to work with
  63. ZDCS 2.0.  Don't forget to create the new configuration file - the
  64. format of ZDCS.CFG =has= changed from version 1.65.  If you try
  65. running ZDCS 2.0 with the old 1.65 format config file, you'll have
  66. problems.
  67.  
  68. Here is a sample config file ZDCS.CFG and an abbreviated explanation
  69. of each line.  For the full story, check the manual.
  70.  
  71.   Line 1
  72.   
  73.   This line is the complete drive, path and filename of the download
  74.   path list.  That list is an ASCII text file showing all the
  75.   pathnames, one on each line, that contain the zipfiles / GIFs to be
  76.   included in the database. There is no upper limit on the number of
  77.   pathnames that can be processed.  It does not matter whether you've
  78.   included the trailing backslash for each pathname.
  79.   
  80.   Line 2
  81.   
  82.   This line is the complete drive, path and filename giving the
  83.   location of the ZDCS database (ZDCS.NDX and ZDCS.DAT).  It makes no
  84.   difference if you include the trailing backslash here or not.
  85.   
  86.   
  87.   Line 3
  88.   
  89.   This line is the complete drive, path and filename giving the location
  90.   of the privileged user list file.  The format of the file containing
  91.   the privileged user list is straightforward:  one name per line,
  92.   ending each line with a CR/LF.  The list is not case-sensitive, nor is
  93.   there a maximum number of names you may put in the privileged user
  94.   list.  Any file uploaded by a prvileged user will be explicitly passed
  95.   by ZDCS, whether or not the file actually contains duplicates.  If you
  96.   don't want to have any privileged users on your system, simply leave
  97.   this line blank.
  98.   
  99.   
  100.   Line 4
  101.   
  102.   This line is either the letter "Y" or the letter "N".  It controls
  103.   whether you want ZDCS to add the disposition line to the end of the
  104.   upload description.  The disposition line shows the total number of
  105.   files in an upload and the number those that were duplicate files.
  106.   ZDCS has to be running in standalone mode for this, not with any of
  107.   the gateways such as with Extest.  Please note that you must be
  108.   running PCBoard 14.5a in order to make use of this new feature, and
  109.   that the third command line parameter must be specified (ZDCSFC %1
  110.   %2 %3) in your PCBTEST.BAT file.  Otherwise, leave this fourth line
  111.   of the config set to the letter "N".
  112.   
  113.   
  114.   Line 5
  115.   
  116.   This line is either the letter "Y" or the letter "N".  It controls
  117.   whether you want ZDCS to truncate nulls from the end of "other"
  118.   type files before performing any operations on them.  The
  119.   truncation is actually done on a copy of the file and the original
  120.   is left intact.  The advantage of using this feature is increased
  121.   accuracy when the same file is uploaded by different transfer
  122.   protocols.  The disadvantage is that it adds a bit of time to the
  123.   upload checking and database build operations.
  124.   
  125.   
  126.   Line 6
  127.   
  128.   This line is an integer - that's a whole number, no decimals -
  129.   between 0 and 100.  It sets the maximum percentage of dupes that
  130.   your bbs will accept in an upload.  Setting the percentage to 100
  131.   effectively bypasses this filter, since it permits a duplicated GIF
  132.   or a zipfile with nothing but duplicates to pass.  At the other
  133.   extreme, setting the percentage to 0 effectively requires that the
  134.   uploaded GIFs and zipfiles have no duplicates at all.
  135.   
  136.   
  137.   Line 7
  138.   
  139.   This line is the complete drive, path and filename you want ZDCS to
  140.   use for the log file created by the upload file checker ZDCSFC.
  141.   This log is an ASCII text file that contains information from the
  142.   upload file checker ZDCSFC for each upload it has processed.  If
  143.   PCBOARD.SYS is in the current directory when the upload file
  144.   checker is run, then the name of the currently logged caller is
  145.   also included in the log file.
  146.   
  147.   
  148.   Line 8
  149.   
  150.   This line is either the letter "Y" or the letter "N".  It controls
  151.   the switch to tell ZDCS whether to delete bbs ads (Y) in an
  152.   uploaded zipfile or to just flag them (N).  If you've decided not
  153.   to enable any checking for bbs ads at all, just set this to N.
  154.   
  155.   
  156.   Line 9
  157.   
  158.   This line is either the letter "Y" or the letter "N".  It controls
  159.   whether you want ZDCS to delete all duplicate files from an upload
  160.   (Y) or just flag them and leave them intact (N).
  161.   
  162.   
  163.   Line 10
  164.   
  165.   This line is reserved for a single line of text by the sysop.  The
  166.   contents of this line are appended to the PCBFAIL.TXT file whenever
  167.   an upload is declined.  The caller who has just uploaded the
  168.   declined file sees this line of text as a message on the screen.
  169.   You can make use of PCBoard @variables and &filespec to your
  170.   heart's content; both are fully supported here.
  171.   
  172.   
  173.   Line 11
  174.   
  175.   This line contains the filename ZDCSFC.OUT and nothing else.  For
  176.   all practical purposes, this line is planning for the future.
  177.   Leave this line set to ZDCSFC.OUT until further notice or features.
  178.   
  179.   
  180.   Line 12
  181.   
  182.   This line is the complete drive and pathname of a RAM drive that is
  183.   available to ZDCS for certain types of processing work.  The
  184.   existance of the RAM drive is verified by ZDCS, but the amount of
  185.   space available on it is not checked.  If you run out of space on
  186.   the RAM drive while ZDCS is processing an upload, the upload will
  187.   be declined.  If you do not want to use a RAM drive, leave this
  188.   line blank.
  189.   
  190.   
  191.   Line 13
  192.   
  193.   This line consists of the single letter "Y" or "N".  It controls
  194.   whether ZDCS displays the one line "registered to" message after
  195.   the board receives an upload (Y) or turns off the display of this
  196.   message (N).  This line is only recognized by the registered
  197.   version of ZDCS.  It has no effect on the three line message
  198.   displayed by the unregistered version.
  199.  
  200.  
  201. To run ZDCS 2.0, you need to copy the new files into your ZDCS
  202. directory.  Copy the executables (ZDCSFC.EXE, ZDCSDB.EXE, ZDCSDR.EXE
  203. and ZDCSBA.EXE), the new format database (ZDCS.NDX and ZDCS.DAT) and
  204. your configuration file (ZDCS.CFG) right over the old files.  That's
  205. it.  You're online with ZDCS 2.0.  Of course, if you have any of the
  206. accessory utilities (like ZDCSDBMG, the database merge program),
  207. you'll have to upgrade them to the new version in order to use them
  208. with ZDCS 2.0.  You'll find a collection of goodies for ZDCS 2.0
  209. available for download from The Hacker Central BBS.
  210.  
  211. As an optional step, you can also decide to reconcile your path
  212. information.  To do this, you need to generate a new PCBoard IDX file
  213. for your entire download system and then run the ZPATH-P.EXE utility
  214. against your new database.  ZPATH-P is one of the accessory utilities
  215. available on The Hacker Central BBS.
  216.  
  217.